SetPlatformShape

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODShape

SetPlatformShape
The SetPlatformShape method modifies this shape to make it equivalent to the specified graphics-system-specific shape.
void SetPlatformShape (in ODGraphicsSystem graphicsSystem,
                       in ODPlatformShape platformShape);
graphicsSystem
A 16-bit value specifying the graphics system for which you are specifying a shape. Valid graphics systems are platform dependent.
platformShape
A 32-bit value identifying a valid graphics-system-specific shape. Valid values for c are graphics-system-dependent.

DISCUSSION
Depending on the platform and graphics system you use, the specified graphics-system-specific shape may or may not be copied. On the Mac OS platform, the graphics system may be either QuickDraw (kODQuickDraw) or QuickDraw GX (kODQuickDrawGX).

If you specify the QuickDraw graphics system, the platformShape parameter is a QuickDraw region handle (type RgnHandle). This region handle is not copied; it is owned by this shape and you cannot modify it or deallocate its storage.
If you specify the QuickDraw GX graphics system, the platformShape parameter is a QuickDraw GX shape (type gxShape). This QuickDraw GX shape is not copied; it is owned by this shape and you cannot modify it or deallocate its storage.

EXCEPTIONS

kODErrInvalidGraphicsSystem
This implementation of OpenDoc does not support the specified graphics system, or that graphics system is not installed or available.
kODErrInvalidPlatformShape
Either the graphics system is QuickDraw and this shape is a null region or the graphics system is QuickDraw GX and this shape's type is not one of polygon, rectangle, path, empty, or full.

SEE ALSO
The ODGraphicsSystem type (page 883).
The ODShape::GetPlatformShape method (page 639).